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PREFACE 



f This publication is a reference manual for the programmer using the MP-60 

COMPrehensive ASsembly System (COMPASS) language. The manual defines the 
„ external characteristics of the MP-60 COMPASS, that is, those features which are 

V, :'- observable or under the active control of the user. 

Knowledge of the MP-60 computer operation is assumed for this manual. The 
\ operation of the MP-60 machine instructions is described in the MP-60 Computer 

System Reference Manual (Control Data publication No. 14306500). 
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INTRODUCTION 



MP-60 COMPASS is the COMPrehensive Assembly System for the CONTROL DATA® 
MP-60 Computer System. MP-60 COMPASS translates the programmer's symbolic 

^ assembly language into machine language instructions, assigns storage locations, and 

C produces a printed assembly listing and a loadable output. 

MP-60 COMPASS LANGUAGE 

I 

The MP-60 COMPASS assembly language is designed to enable efficient use of all the 
computer resources while giving the programmer maximum flexibility in program 

1 construction. The language allows all hardware functions of the MP-60 computer system 

to be expressed symbolically. The user writes machine language programs in 
mnemonic instructions and symbolic addresses. In addition to individual computer 

V instructions and data items, MP-60 COMPASS accepts programmer-defined macros. 

Programmer-defined macros allow definition of a sequence of instructions as a macro. 
Once the macro is defined, each time the associated macro name appears, the 
sequence of instructions will be inserted by the MP-60 COMPASS assembler. 



V In order to simplify program coding and debugging, MP-60 COMPASS provides a 
number of pseudo instructions which control the assembly process. A number of 
the features of MP-60 COMPASS are summarized in the following listing. 

i. 

\ 

• Address Arithmetic and Validation 
i 

V Constants, symbolic addresses, and arithmetic expressions may be used to 

represent the value of the address field. 

( 

• Preloaded Data 

I' Data storage areas may be specified and loaded with values at the same time 

<J the program is loaded. These areas may be used for subprogram communications. 

C • Common Assignment 

Common areas may be designated to provide for communication among MP-60 
/ COMPASS subprograms. 

• Data Definition 



Integer, floating point, ASCII, and hexadecimal constants may be coded using 
familiar notation. 
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• Variable Fiel d Definition 

D 

Structured information can be linked as arbitrary fields within core storage 
with little regard for word boundaries. 

• Listing Control 

The format of assembly listings may be controlled with pseudo instructions. 1 

• Diagnostics 

J 

Diagnostics (error flags) for source program listings are included in the 
output listing. 

• Macro 

The capability to define, retrieve, and expand macros is provided. Macros may * 

be nested. 

• IF Statements : 
The conditional assembly of statements is provided by IF and ENDIF statements. V„_y | 

• Relocation 

Subprograms may be defined at absolute or relocatable origins. Multiple use of 
the ORG or ORGR statements is allowed, within specified limits. 

• Subprogram Linkage 

Statements that define the entry points and external linkage of a subprogram '; 

are provided. 

• Assembled Listing <[*"'?. 

A listing containing source program statements, the resulting object code, 

program size, core storage assignments, and a cross-reference of symbol |y 

definitions and address field use is given. 

COMPASS SUBPROGRAMS 






To execute a program, the operating system often loads and links together several .„. 

routines that have been assembled separately. For this reason, it is customary to J 

refer to individual COMPASS routines as subprograms. 



<J 



l> 
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COMPASS accepts assembly language subprogram inputs on cards, magnetic tape, or 
disk in source language. It translates these source language statements into machine 
language instructions, and data, which are referred to as object code. Object code 
is prepared in a loadable format that can be loaded into memory when the program 
is to be executed. The assembler produces the following outputs: 



• 



• 



A printer listing of the assembled subprogram with hexadecimal object code 
and symbolic source instructions side by side. Error diagnostics automatically 
accompany this listing. 

Loadable binary output for subsequent loading and execution of the assembled 
subprogram. 



Each subprogram consists of an IDENT pseudo instruction, subsequent lines of coding, 
and an END pseudo instruction. The last subprogram must be immediately followed 
by a FINIS pseudo instruction. Subprograms communicate with each other by use of 
entry points and external symbols (ENTRY and EXT pseudo instructions). 

Three main regions provide storage for assembled subprograms. 

• Data common region 

! • Scratch common region 

• Subprogram region 

( 

The three types of regions are defined at assembly time. When more than one sub- 
program is to be loaded for execution at run time, the first specification of a data 

1 or common region must be the maximum length region for all programs loaded. 

COMPASS object code may contain relocatable addresses, which are modified by a 
\ relocation factor during loading to obtain the actual address in the computer memory. 

When assembling subprograms, COMPASS assumes that the initial location in each of 
g-, the three types of regions (data, subprogram, common) has a relocatable address of 

\ zero. Locations are then assigned sequentially from zero unless the pseudo instruction 

ORGR is encountered. ORGR instructs COMPASS to assign the value in the address 
/ field of ORGR as the relocatable address of the following instruction and assign storage 

V sequentially from that relocatable address. The address counter affected by ORGR 

is the counter in use when ORGR is processed. All counters are initialized to zero 
/' before assembling a new subprogram. 
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COMPASS PROGRAMS 



An MP-60 COMPASS subprogram consists of a sequence of symbolic source statements. 
These statements are made up of language elements combined in accordance with a set 
of definable rules. 

Statements fall into four categories: 

• A normal statement, which is assembled and which may produce loadable output 

• A control statement, which affects the operation of the assembler 

• A statement that is part of a definition (those lines contained between a macro 
and its ENDM) 

• A comment statement, which appears in the listing but has no effect upon the 
assembly 



Elements are classified as follows: 

I 

• Operation codes 

| • Pseudo operation codes 

• Symbols 

* • Constants 

*-■■■ • Literals 

• Operators 
C • * (asterisk) 

• Macro names 

K - STATEMENT FORMAT 



COMPASS statements are written on coding forms (refer to Figure 2-1) and subsequently 
punched into cards or prepared on other media for input to COMPASS. Each line on the 
coding sheet is normally punched into a single card. The correspondence between 
columns on coding sheets and cards is one to one. 
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NOTE: The coding form shown Ls presented as an illustration of a typical 

form. Field boundaries shown are not to be construed as limitations 
of COMPASS. 



Figure 2-1. Typical COMPASS Coding Form 
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Each line of code is field free; all statements are defined in terms of the contents of 
the following fields. 



1) 
2) 



Field 



Location 



Operation 



3) Address 



4) 



Comments 



Columns 

The location field begins in column 1 and is terminated 
by the first blank column. 

The operation field contains the operation code. The 
field begins after the first blank column and is terminated 
by a blank. 

The address field begins after the blank terminating the 
operation field and terminates with a blank or column 80. 

If an address field is used, the comments field starts 
after the blank ending the address field. If an address 
field is not required, the comments field is separated from 
the operation field by at least one blank. If an address 
field is required but is blank, comments must start after 
column 40. Comments may extend through column 80. 



( 



LOCATION FIELD 

The location field begins in column 1 and is terminated by the first blank. It may 
not extend for more than eight characters. The location field may contain a symbol 
or an asterisk (*), or it may be left blank. 

The location field symbol is used to identify a position within a subprogram or may be 
equated to a value. This symbol can be referenced by an instruction or pseudo 
instruction throughout the program. A location field symbol consists of from one to 
eight characters. The first character of a symbol must be alphabetic and must be 
placed in column 1. 

Embedded blanks are illegal. An illegal symbol is flagged as an L error on the 
assembly listing. 

When an asterisk appears in column 1, columns 2 through 80 are treated as a comment. 



o 
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Examples of location field symbols: 



d 



Acceptable 
A 123456 
H3 
ABCDEFGH 



Unacceptable 

12345678 

.2345678 

TOOMANYCHARACTERS 



OPERATION FIELD 

The second field on the COMPASS coding form is defined as the operation field. 

The operation field may contain instruction mnemonics with specific related modifiers, 

pseudo instruction mnemonics, or macro instruction names. 

An operation code modifier may occur after the mnemonic to further define the 
desired instruction. Modifiers are separated from operation codes by commas. 

Illegal operation codes and modifiers are flagged as diagnostic errors on the 
assembly listing. 

Examples of acceptable and unacceptable operation fields are as follows: 



\^i 



Acceptable 


Unacceptable 


Reason 


STC.F 


STC, 


Illegal terminator 


LDH, F 


LDHF 


Missing comma 


BSS.D 


R 


No modifier 



ADDRESS FIELD 

The third field coded on the COMPASS coding form is the address field. The contents 
of the address field are dictated by the operation code. The address field begins after 
the blank terminating the operation field and terminates with a blank or column 80. 

The following terms can be used in the address subfields: 

• Symbols (location or value) 

• Constants 
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• Register designators [constant or symbol (value)] 

• Expressions consisting of symbols and constants joined by operators 

• Asterisk 

• Double Asterisk 



SYMBOLS 

{'"'■ 

v A symbol is a string of one to eight characters representing a value or an address. 

A symbol conforms to the rules described for the location field. An address field 

I' symbol may constitute the entire field or it may be one of several elements in the 

field. Any symbol used in the address field must be defined by the appearance in 

the location field of another statement in the subprogram, or it must be declared 

f external (EXT). A symbol may be nonrelocatable or relocatable. 

A nonrelocatable symbol references an absolute address. The value assigned to the 
I nonrelocatable symbol will not be modified during loading. A symbol can be defined 

as nonrelocatable through the use of an EQU pseudo instruction. 



A relocatable symbol represents a symbolic address. Relocatable addresses are 
values related to a predefined memory area. These values are incremented or 

| decremented by the loader prior to loading of the instruction in which the address 

I occurs. Relocatable symbols may be: 

• Subprogram relocatable 
t 

• External symbols 

I • Data relocatable 

• Common relocatable 
v 

A symbol may represent a 16-bit (word), 17-bit (halfword), 18-bit (character), or 
f. : 21-bit (bit) address, and the usage of symbols is interchangeable. If, for example, 

* a word address defined symbol is used in a byte addressing instruction the word 

address is effectively shifted left two places with zero fill. 

( 

1 If a symbol is used in a smaller subfield (such as 18 bit to 16 bit) the address is 

shifted right; if a one bit is lost by the shift, a T error occurs. 



The special symbol, *, may be placed in the address field and used as any symbol. 
The * is interpreted as the current value of the COMPASS counter in effect when the * 
is encountered (program or data). If the machine instruction occupies two words, * is 
the address of the first word. 
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The special symbol, **, may be used as the only entry in a field or subfield. The 
** yields a subfield containing a one in each bit position. Normally, the field 
represented by the ** will be modified during the execution of the program. 

CONSTANTS 

The address field may contain signed or unsigned decimal, hexadecimal, or ASCII 
integers. If the sign is not present, the integer is assumed to be positive. 

The allowable formats in the address field of an instruction are: 

• Decimal 

Any numeric value is processed as decimal. The decimal value may be modified 
by a decimal power of 10 (P), a binary scale factor (S), or both. 



Hexadecimal 

Result (16-bit address) 

0001 

FFFF 

000A 

0005 



Data preceded by a $ specifies a hexadecimal constant. The specified value may 
be modified by a binary scale factor. 



Examples: 


Address field 


Constant 


1 


-1 


1P1 


1P1S-1 


Hexadecimal 



Examples: 



Address Field Hexadecimal 

Constant Result (lG-bit address) 

$A0 OOAO 

$A0S1 0140 

-$1 FFFF 



o 



■'") 






o : 



2-6 14061305 A ) 






( 



£ 



D 



». 



c 



o 



• ASCII 

Data enclosed within apostrophes specifies 8-bit ASCII code characters. Characters 
are right justified with zero fill. Blank is a significant character. 

Examples: 



/ Address field Hexadecimal 

•*'- Constant Result (16-bit address) 

£' , 'B' 0042 

' B' 2042 

-'AA' BEBF 

1 EXPRESSIONS 

In an address field or subfield, symbols, the special symbol, *, and constants 

may be combined with the operators, plus or minus, to form an address expression. 

The value of the expression is calculated by substituting the numeric value of the 

symbol and performing 16-, 17-, 18-, or 21-bit arithmetic with the designated operators. 

External symbols, the double asterisk, and literals may not appear in an address 

expression. 



If relocatable symbols are part of an address expression, the result of the evaluated 
expression must be relocatable within a single area. Subprogram, data, or common 
f relocatable symbols may be mixed: 



D -P +P 2 -D +C -C nonrelocatable value 



^ D-C +C positive data relocatable value 

I** C -P-C negative subprogram relocatable value 



D. = data common relocatable addresses 
l 

P. = subprogram relocatable addresses 



{ C. scratch common relocatable addresses 

In an expression containing relocatable symbols, the algebraic sum of the relocation 
I indicators must be either an area relocation increment or decrement, or no relocation 

designator and, therefore, a nonrelocatable value. 



The result of an address arithmetic symbol depends on the number of bits assigned to 
the subfield in the object code. 
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LITERALS 

If the address field or subfield of an instruction refers to an operand which may be a 
single or double precision value, the entry may be a literal expressed as an equal 
sign followed by a mode designator and a value (=mv). The absence of a mode 
designator implies decimal mode. 

The equal sign denotes that the field contains a literal; m indicates the mode of 
the literal; v is the value of the literal. The precision of the literal is derived 
from the precision of the operation performed (LD, LDD, etc.). 

The mode of a literal may be decimal, hexadecimal, ASCII, or symbolic. 

Decimal Literals: =v 

The value of the decimal literal is expressed in the same manner as the GEN pseudo 
instruction; they may be signed, cannot be more than 10 digits (20 for double precision), 
and may be followed by a scaling factor. A blank terminates the field. If a decimal 
point (.) is encountered in the literal, the value is converted to floating point format. 

Hexadecimal Literals: =$v 
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The value of the hexadecimal literal is written in the same manner as a GEN pseudo V .^j 

instruction; it may be signed, cannot be more than eight digits (16 for double precision), 

and may be followed by a scaling factor. A blank terminates the field. A nonhexadeci- 

mal character is illegal. ) 

ASCII Literals: ='v' 

« ^ 

The ASCII literal is expressed as a string of up to four or eight characters enclosed in 
quote (') marks. Blanks are significant in an ASCII literal. 

' J 
Symbolic Literals: =Sv 

The symbolic literal is expressed as a legal COMPASS symbol. The symbolic literal ^ 

causes storage to be reserved for the symbol. 

During assembly, a literal is converted to binary and assigned a relocatable address i;1 * 
which is substituted for the literal in the object code. Literals are assigned to contig- 
uous storage locations at the end of the subprogram. Literals of the same value and 0& 
size are not duplicated in the object subprogram. Each time COMPASS encounters a ^ 
literal, the value is compared against all previously assembled literals; and if an iden- 
tical value exists, the address of the previously assigned literal is substituted in the "| 
object code. lsi * 



o 



1 
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COMMENTS FIELD 

(/ Comments may be included with any instruction. The comments field may begin 

after the blank column that terminates the address field and may extend through 
column 80. If the instruction has no address field, comments can begin in 
column 41. The comments field has no effect on the assembly but its contents 
are printed on the output listing. If an asterisk is placed in column 1, the 

f " : e. assembler interprets the entire line as comments. 

REGISTER EQUATES 

I 

The COMPASS assembler will preset the following equates which are used as a 

coding convention in defining register equates. 






c 



P 



xo 


EQU 





XI 


EQU 


1 


X2 


EQU 


2 


X3 


EQU 


3 


X4 


EQU 


4 


X5 


EQU 


5 


X6 


EQU 


6 


X7 


EQU 


7 


HO 


EQU 


8 


HI 


EQU 


9 


H2 


EQU 


10 


H3 


EQU 


11 


H4 


EQU 


12 


H5 


EQU 


13 


H6 


EQU 


14 


H7 


EQU 


15 



R0 


EQU 


16 


Rl 


EQU 


17 


R2 


EQU 


18 


R3 


EQU 


19 


R4 


EQU 


20 


R5 


EQU 


21 


R6 


EQU 


22 


R7 


EQU 


23 


R8 


EQU 


24 


R9 


EQU 


25 


RA 


EQU 


26 


RB 


EQU 


27 


RC 


EQU 


28 


RD 


EQU 


29 


RE 


EQU 


30 


RF 


EQU 


31 
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PSEUDO INSTRUCTIONS 



P 



Pseudo Instructions are nonmachine language instructions used to prepare a 
subprogram for COMPASS assembly. Some of the pseudo instructions provide the 
COMPASS assembler with the required information. Others are programmer aids 
for defining parts of a program, allocating storage, declaring symbols and constants, 
and generally controlling the assembly and listing processes. The pseudo instructions 
associated entirely with macros are discussed in Section 4. 



D 



PROGRAM SECTIONING AND LINKING 

This group of pseudo instructions defines the name, beginning, and end of a sub- 
program and the linkage between subprograms during execution. 



IDENT 



Location 


Operation 


Address 


Comments 


1 8 


10 


' 20 


1 41 

I 1 _Ll 




IDENT 


1 

1 m 


1 



c 



IDENT defines the name and beginning of a subprogram. The address field contains 
the subprogram name. It may include from one to eight characters. The sub- 
program name is printed as the title on the output listing unless a TITLE listing 
control pseudo instruction intervenes. The location field should be blank; it is ignored 
by COMPASS. IDENT must be the first statement of a subprogram. Instructions 
following the IDENT statement are assembled using the subprogram address counter. 



14061305 A 



3-1 



^Hiif^ 



END 



Location 


Operation 


Address 


Comments 


1 8 


10 


20 


41 


Symbol 
or blank 


END 


m 





.) 



END terminates a subprogram. The symbol (m) in the address field is used as 
the symbolic transfer address. This is the starting address for execution. The 
symbolic transfer address, if used, must also be defined as an entry point in the 
subprogram. The location field may be used to define the last location of the 
subprogram. 

ENTRY 



Location 


Operation 


Address 


Comments 


1 8 


10 


20 


i« 




ENTRY 


m l» m 2 


1 

1 ., m 

1 n 



ENTRY defines one or more locations which may be referenced by another sub- 
program if the same location is defined as external in the other subprogram. The 
address field contains one or more location names separated by commas; it may not 
contain blanks. The location names must be defined in the subprogram; otherwise, an 
error occurs. 

EXT 






Location 


Operation 


Address 


Comments 


1 8 


10 


20 


41 




EXT 


m i' m 2'-- 





o 



EXT declares the symbols in the address field to be external to the subprogram. The 
address field contains one or more names separated by commas; it may not contain 
blanks. The symbol may not be defined within the subprogram which declares it as 
external. 
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SCOM 



Location 


Operation 


Add 


ress 


Comments 


1 8 


10 


20 




! 41 
1 


Symbol 


SCOM 


m 




1 
i 



0°*\ 



The SCOM statement defines storage in common. The location field defines the name 
of the (scratch) common block. The address field may specify the block length, or 
if the address field is blank, the assembler determines the block length. An attempt 
to allocate more memory than declared as the block length is an error. The location 
name and address field are used to establish subprogram linkage. The block is used 
by the subprogram in common with all other subprograms declaring, by location field 
symbol, the same block. 

A subprogram may contain up to 30 common blocks (scratch and data). A program, 
consisting of many subprograms, may contain as many common blocks as available 
memory allows. The programmer may label, reserve, or otherwise organize scratch 
common, but information may not be assembled in scratch common. 

Example: 



€ 

€: 



BLOCK1 

ARRAY 

BUFFER 

BLOCK2 

SCRATCH 

TEMP 

TEMP2 



SCOM 




BSS 


10 


BSS.C 


100 


SCOM 




BSS 


5 


BSS 


1 


EQU 


TEMP 



9 
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DCOM 



Location 



Symbol 



Operation 



Address 



Comments 



10 



20 



141 



DCOM 



I 



m 



The DCOM statement defines data common. The location field defines the name of the 
common block. The address field may specify the block length or, if the address field is 
blank, the assembler determines the block length. An attempt to allocate more memory 
than declared as the block length is an error. Data common differs from scratch common 
in that data may be assembled in the data block. 

Example 





DATAl 


DCOM 


3 


LETTERS 


GEN 


$41, $2400, $43 


DATA 2 


DCOM 


11 


DIGITS 


GEN 


0,1,2,3,4,5, 6, 7,8, 9,$F 


COMPO 


OL 








Location . 


Operation 


Address Comments 




1 8 


10 


j 20 j 41 






COMPOOL 


!m ' 



I 

The COMPOOL statement causes COMPASS to search the Library file for the named com- 
mon source code string. The address field specifies the name of the common structure to 
be extracted from the library file (refer to Figure D-l). A COMPOOL entry on the 
library must conform to the rules of the SCOM and DCOM statements. COMPOOL is 
intended to aid the programmer in managing common blocks between a number of subpro- 
grams. An alternate library (other than the system library) file may be specified on the 
COMPASS control card (refer to B-l). Appendix D contains a description of the library 
file. 
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PROGRAM CONTROL 



This group of pseudo instructions defines the beginning and end of an assembly of one or 
more subprograms. This group also includes pseudo instructions which control the 
conditional assembly of source statements. 



ORG 






Location 


Operation 


Address 


Comments 


1 8 


10 


1 
| 20 


1 

1 41 




ORG 


1 

1 m 
1 


1 
1 
1 



ORG defines the subprogram to be absolute. The ORG pseudo must precede any 
instruction or data generation statements. The address field (m) term may contain 
a nonrelocatable symbol, value, or *. If the address field is not blank, the address counter 
is set to the value specified. The subprogram address counter may be reset to the pro- 
gram address (not common) it had prior to the last ORG occurrence by entering an asterisk 
(*) in the address field of the ORG statement. Either an ORG or an ORGR statement, but 
not both, may be used an unrestricted number of times in a subprogram. 



Example: 



IDENT 



L 




0100 




ORG 
LD,4 


(: 




• 










01FF 




ST,1 


i 


Subprogram 


0200 




ST, 2 




Address 


0201 




ST, 3 





Counter 






ORG 


r 




0400 


PI 


GEN 




0401 


DTORAD 


GEN 


Q. 
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0202 




ORG 
LDC, 



ROUTINE7 

$100 

WORK 



BUFF 
BUFF+1 
BUFF+2 
$400 



3.14 
0.0175 



'X' 



3-5 






ORGR 



Location 



Ope ration 



10 



ORGR 



Address 



20 



m 



Comments 



41 



The address field (m) term must contain a relocatable symbol or an asterisk. If 
the address field is not *, the address counter is set to the value specified. The 
subprogram address counter may be reset to the program address (not common) it had 
before the last ORGR statement by entering an asterisk (*) in the address field of the 
ORGR statement. Either an ORG or an ORGR statement, but not both, may be used 
an unrestricted number of times in a subprogram. 
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CONDITIONALS 

The source of subprogram assembly may be conditional as stated by the pseudo instruc- 
tions listed below. COMPASS tests for the condition and includes or omits subsequent 
lines of code, depending on the outcome of the test. 

IF Zero 

IFZ Zero 

IFG Greater than or equal to zero 

IFGE Greater than or equal to zero 

IFGT Greater than zero 

IFL Less than or equal to zero 

IFLE Less than or equal to zero 

IFLT Less than zero 

IFN Not equal to zero 
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IF 



Location 



Operation 



Address 



Comments 



10 



IF 



20 



m 1 ,m 2 



41 



If the value of m ± is zero, begin assembly with the next statement. If the value of m 1 
is not zero, input cards are skipped depending on the value of m 2 . 



m„ 



m r 



An expression, the value of which is computed as any address 
expression and evaluated module 2 16 -1 with sign extended. 



If the term is a symbol, cards are processed according to the 
conditional until an ENDIF card with the same symbol in the 
location field is encountered. If m 2 is blank, cards are pro- 
cessed according to the conditional until an ENDIF card with 
a blank location field is encountered. 



The range of the conditional will be terminated by a FINIS or END statement, and if the 
conditional started within a macro definition, its range cannot extend beyond the macro 
definition. 



IFZ 



Location 



Operation 



10 



IFZ 



Address 



Comments 



20 



m l> m 2 



41 



IFZ is the same as IF. 
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IFG 



Location 


Operation 


Address 


Comments 


1 8 


10 


20 


41 




IFG 


m i> m 2 





IFG is the same as IF, except the test is for the value of m greater than or equal to 



zero. 



IFGE is the same as IFG. 



o j 



IFGE 



Location 



Operation 



10 



IFGE 



Address 



20 



m , m 2 



Comments 



41 
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IFGT 



Location 

1 8 



Operation 



10 



IFGT 



Address 



20 



m i' m 2 



Comments 



41 



IFGT is the same as IF, except the test is for the value of m greater than zero. 
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IFL 



" 
Location 


Operation 


Address 


Comments 


1 8 


10 


i 20 
I 


41 




IFL 


| m l» m 2 





IFL is the same as IF, except the test is for the value of m less than or equal to zero. 






IFLE 



Location 


Operation 


Address 


Comments 


1 8 


10 


20 


i 41 




IFLE 


m v m 2 ! 



IFLE is the same as IFL. 



( 



IFLT 



Location 


Operation 


Address 


Comments 


1 8 


10 


i 20 
1 


41 




IFLT 


| m i' m 2 





€ 



IFLT is the same as IF, except the test is for the value of m less than zero. 
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IFN 



Location 

1 8 


Operation 
10 


Address 
! 20 

! 


Comments 
41 







IFN 


I m r m 2 





IFN is the same as IF, except the test is for a value of m not equal to zero. 
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ENDIF 



Location 



Symbol 
or blank 



Operation 



Address 



Comments 



10 



20 



ENDIF 



41 



The ENDIF statement is used with the IF statement. An ENDIF ends the skipping of 
source statements initiated by an IF statement. If the symbol in the location field of 
an ENDIF statement does not match the symbol in the address field of an IF statement, 
the ENDIF statement is ignored and the skipping of input cards continues. 
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FINIS 



:',) 



Location 



Operation 



10 



FINIS 



Address 



20 



Comments 



41 



FINIS is the final instruction of an assembly run and indicates that all subprograms 
have been submitted for assembly. Location and address fields are ignored. FINIS 
should immediately follow an END pseudo instruction. 

COMPASS recognizes FINIS at any point. The occurrence causes the assembler to 
return to the operating system. 

Example: 



IDENT 



TEST 



vyjj 



END 
IDENT 



TEST 1 



END 

FINIS 



J 
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SYMBOL DEFINITIONS 

A symbol in the location field may be defined by equating it to the value of another 
symbol, a constant, an asterisk, or an expression of the address field. It may be de- 
fined as an absolute value or a relocatable address (word, half word, byte or bit). If a 
symbol is declared an entry point, it must not be equated to a symbol declared as 
external. When symbols are equated, they are identical and interchangeable. 

All symbols in the address field must have been previously defined by appearance 
in the location field of a preceding instruction or pseudo instruction. 



EQU 



Location 



Symbol 



Operation 



10 



EQU 



Address 



Comments 



I 20 



m 



41 



P 



The location symbol is equated to the symbol, value, or expression in the address field. 
The symbol in the location field takes on the attributes of a relocatable symbol in the 
address field (word, half word, byte or bit). If the location field does not contain a 
symbol, an error occurs. 

The address field determines the definition of the symbol in the location field. It may 
contain: 

i fi 

• An integer modulo 2-1. 

• A symbol defined by appearance in the location field of a preceding instruction. 
If the symbol in the address field is relocatable to a given area (program, 
SCOM, DCOM), the symbol in the location field is also relocatable to that area. 

• An address expression containing symbols defined as above and conforming 
to the rules for address subfields. 



14061305 A 



3-9 



EQU,H 



0' 



Location 



Symbol 



Operation 



Address 



10 



I 20 



EQU.H 



I 



Comments 



» 41 



I 
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The symbol is equated to a 17-bit address, 17-bit constant, or another symbol. If 
the location field does not contain a symbol, an error occurs. 

The address field determines the definition of the symbol in the location field, as 
for the EQU pseudo. However, the resultant value must be consistent with 
modulo 2 11-1 arithmetic and half-word address subfields. 



) 



EQU.C 



Location 


Operation 


Address 


Comments 


1 8 


10 


20 


41 


Symbol 


EQU.C 


C 





The symbol is equated to an 18-bit address, 18-bit constant, or another symbol. If 
the location field does not contain a symbol, an error occurs. 

The address field determines the definition of the symbol in the location field, as 
for the EQU pseudo. However, the resultant value must be consistent with modulo 
2l8-i arithmetic and byte address subfields. 
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EQU,B 



Location 


Operation 


Address 


Comments 


1 8 


10 


20 


!« 


Symbol 


EQU.B 


b 


i 
1 



The symbol is equated to a 21-bit address, 21-bit constant, or another symbol. If the 
location field does not contain a symbol, an error occurs. 

The address field determines the definition of the symbol in the location field, as for the 
EQU pseudo. However, the resultant value must be consistent with modulo 221-1 arith- 
metic and bit address subfields. 
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EQU,W 



Location 


Operation 


Address 


Comments 


1 8 


10 


20 


41 


Symbol 


EQU,W 


m 





The EQU, W pseudo instruction differs from the EQU pseudo in that it forces the symbol 
in the location field to be defined as a word address symbol. 

The address field determines the definition of the symbol in the location field and consists 
of a 16-bit constant, symbol or expression consistent with word address subfields. 



SET 



Location 


Operation 


Address 


Comments 


1 8 


10 


20 


41 


Symbol 


SET 


m 





SET functions in almost the same manner as an EQU pseudo instruction. The only 
difference is that SET may be used to repeatedly redefine a location field symbol. If a 
location field symbol is redefined with the EQU instruction, an error occurs. The same 
modifiers apply to SET as to EQU with the results being identical. 



STORAGE DEFINITIONS 



Storage definition statements are used to reserve storage for specific symbols. This 
group of statements usually has a location field symbol which allows other source 
statements to reference the defined block of reserved storage. 
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BSS 



Location 



8 



Symbol 
or blank 



Operation, Modifier 



Add ress 



10 



20 



BSS 



I 



m 



I 



Comments 



i 41 



BSS reserves and labels a block of words in any area. The location field may be blank 
or contain a symbol defined as the first word in the reserved block. The address field 
specifies the number of words to be reserved and must contain a constant, a symbol, 
or an address expression which results in a nonrelocatable value. The double asterisk 
in the address field is illegal; symbols in the address field must be defined in the 
location field of a preceding instruction. 



a 



If the address field is in error or is zero, no storage is reserved but a symbol in the 
location field is defined. If the preceding instruction assigned memory in other than 
word mode, a BSS forces the next instruction, which consumes space to a new word. 



Examples: 

ALPHA TEXTC 3, ABC ALPHA 

BSS 

TEXTC 3.GHI ALPHA+1 G H I 



V.yf 



ABC 



ALPHA TEXTC 3, ABC 



ALPHA 



B 



u 



TEXTC 3.GHI ALPHA+1 H I 
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BSS,H 



<U 



^»/ 



Location 



8 



Symbol 
or blank 



Operation 



Address 



Comments 



10 



BSS.H 



20 



! 41 



m 



BSS.H reserves and labels a block of half-word positions. The location field may be 
blank or contain a symbol which is defined as a 17-bit address of the first half word 
in the block to be reserved. The address field specifies the number of half words to 
be reserved. It must contain a constant, a symbol, or an address expression which will 
result in a nonrelocatable value. 

A zero address field does not reserve space, but the location field symbol is defined. 
BSS.H will assign the first half-word position at a half-word boundry consistent with 
preceding memory usage. 



Examples : 



ALPHA BSS, C 3 

BETA BSS, H 3 

ALPHA BSS.C 2 

BETA BSS, H 3 



ALPHA 
BETA 

ALPHA 
BETA 



l« 


C2 


C3 




HI 


H2 


H3 






CI 


C2 






HI 


H2 


H3 
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BSS,C 






Location 



Symbol 
or blank 



Operation 



10 



BSS.C 



Address 



20 



m 



I 



Comments 



41 



b *Ll° ^ l a , bl ° Ck ° f byte ° r characte ' Positions. The location field may 

the hw„ 7 k " S r b01 WMch iS d6fined as an 18 " bit addres « <* ^ e first byte in 

he block to be reserved. The address field specifies the number of bytes to be reserved 

relZlT^. ^^ * ^^ °"* " ddl - ^^^ WMch »* -suit in a n^' 

LTc^nlZ^lt d ° f eS ™\ rese ™ s P ace . but the location field symbol is defined. 

memorv IT ^ t ^ P ° Siti ° n at a b *e boundary and consistent with preceding 

memory usage, as shown for BSS.H. <= U « 1S 
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BSS.B 



Location 



Symbol 
or blank 



Operation 



Address 



Comments 



10 



BSS.B 



20 



, 41 
J 



m 



BSS.B reserves and labels a block of bit positions. The location field may be blank or 
contain a symbol which is defined as a 21-bit address of the first bit in the block to be 
reserved. The address field specifies the number of bits to be reserved. It must 
contain a constant, a symbol, or an address expression which will result in a nonrelocat- 
able value. 

A zero address field does not reserve space, but the location field symbol is defined. 
BSS.B will assign the first bit position following the last entity boundry assigned by the 
preceding instruction (word, half word, byte, or bit). 
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BSS,D 



c 



f 

X 



Location 



Symbol 
or blank 



Operation 



10 



BSS,D 



Address 



| 20 



I 



m 



Comments 



41 



I 



BSS.D reserves and labels a block of double-word positions. The location field 
may be blank or contain a symbol which is defined as a 16-bit address of the 
first word pair in the block to be reserved. The address field specifies the 
number of double words to be reserved. It must contain a constant, a symbol or 
an address expression which will result in a nonrelocatable value. 

A zero address field does not reserve space, but the location field symbol is 
defined. BSS, D will assign the first position of the block at a word boundry. 



DATA DEFINITIONS 

Data may be stated as hexadecimal, decimal, or ASCII character strings in the 
source language. They may occupy fixed or variable positions in memory, consistent 
with the various address modes of COMPASS. 



GEN 



C 



P 



Location 


Operation 


Address 


Comments 


1 8 


10 


1 20 


41 


Symbol 
or blank 


GEN 




.,m 
n 






GEN.H 










GEN,C 










GEN.B 








1 


GEN.D 







The GEN pseudo instruction causes numeric constants to be assembled in storage. The 
data is organized as single entities of the size specified by the modifier (GEN defines 
word data items, GEN.H half words, GEN.C bytes, GEN.B bits, and GEN.D double word 
data items). The location field may be blank or contain a symbol which specifies the 
address of the first constant in the address field. 
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The address field may express as many constants as can be written through column 80; 
they are separated by commas. Terms cannot be combined into expressions with 
the use of operators. Negative constants are specified by a minus (-) sign; a plus (+) 
sign is optional. Constants are right justified in storage if the definition does not 
fill the data field. A constant may not exceed the size of the specified data field 
(word, half word, byte, bit, or double-word). 

Examples of address field constants are: 

10 decimal integer 

-2 decimal integer 

+38 decimal integer 

5P1 decimal integer, decimal scale factor 

5S-1 decimal integer, binary scale factor 

5P1S-1 decimal integer, both scale factors 

1.5 floating point 

1. 5P3 floating point, decimal scale factor 

$FFF hexadecimal constant 

-$A hexadecimal constant 

'ABC ASCII characters 
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VFD 



Location 



8 



Symbol 
or blank 



Operation 



10 



VFD 



Address 



Comments 



20 



n/m 1 ,n/m 2> . 



41 



, n/m 



n 



Variable field definition (VFD) enters data into variable length fields assigned as continuous 
strings of specified length. Entries in the address field define the list of data stored. 
Each entry consists of a decimal value (n), a slash, and a term (m) which may be either 
a symbol or a constant. The decimal value specifies the length in bits of the term. 
Symbols evaluated as addresses are assembled right-justified in the address .field of a 
word. The address field represents the lower 16 bits (full word), lower 17 bits 
(half word), lower 18 bits (character), or lower 21 bits (bit). The decimal bit 
count determines which type of address is assembled. The data is inserted without 
regard to full word, half word, character, or bit boundaries. The symbol in the 
location field (optional) is assigned the address of the first n/m definition in the 
address field. 



Examples: 



DATA 7 



VFD 
VFD 
VFD 
VFD 

VFD 



16/$EFO0, 8/44, 8/'Z' 

16/0, 16/DATA7. . . . word address 

11/0, 21/WOEK .... bit address 

32/Symbol not legal 

16/A, 16/B not legal if symbol A is 

relocatable 
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TEXT 



5 



Location 



8 



Symbol 
or blank 



Operation 



Address 



Comments 



10 



TEXT 



20 



n ' C l C 2' 



41 



TEXT causes characters to be assembled into words. A character count (n) is specified in 
the address field, followed by the characters to be assembled in the text form. The charac- 
ters are stored as 8-bit ASCII codes in byte format. The character count in the address 
field is expressed in decimal. If n is greater than the number of characters that can be ex- 
pressed on the card through column 80, the additional characters are stored as blanks. If a 
symbol is entered in the location field, the symbol is assigned the address of the first full 
word of text data. If n is not specified, the assembler counts the number of characters 
specified and reserves (through the last non-blank character in or before column 80) enough 
words to contain the characters; then the characters are stored in successive character 
positions. Unused character positions in the last word are filled with blanks. 



TEXTC, TEXTH 



")) 



vy 



Location 


Operation Address Comments 


1 8 


, 1 _ 

10 | 20 | 41 


Symbol 
or blank 

Symbol 
or blank 


TEXTC J n,C n C„ C ! 

• 1 l n 1 

TEXTH ! n,C ,C.....,C J 
■ 1 £ n i 



TEXTC is similar to the TEXT statement. The TEXTC statement causes the 
symbol appearing in the location field to reference the first character address of the 
block of text data stored in memory. 

TEXTH is similar to the TEXT statement. The TEXTH statement causes the 
symbol appearing in the location field to reference the first half-word address of 
the block of text data stored in memory. 
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TITLE 



Location 



Operation Address 



Comments 



10 



TITLE 



20 



Heading 



41 



TITLE causes a heading to be printed at the top of each page of an assembly listing. The 
heading is described in the address field of the statement. The pseudo instruction TITLE 
does not appear on the output listing. Up to 56 characters may be included in the heading. 



(O 



EJECT 



Location 



Operation Address 



Comments 



10 



20 



EJECT 



41 



EJECT causes the next line of the assembly listing to appear at the top of a new page. 



SPACE 



i, 



f 

o 



Location 



Operation Address 



Comments 



10 



SPACE 



20 



m 



41 



SPACE causes the number of lines (m) specified in the address field to be skipped 
on the printed output listing. 
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LISTF 



Location 



Operation Address 



Comments 



10 



LISTF 



20 



! 41 



m 



LISTF is used to inhibit listing large quantities of data associated with certain statements 
like GEN. The address field can contain either ON or OFF. If a LISTF statement is 
used with OFF specified, the pseudo instruction operation code (GEN, for example) is 
printed but multiple lines of associated data are inhibited. Normal listing of statements 
is restored with another LISTF statement, which specifies ON in the address field. 
Normally this switch is ON. 

LIST 



Location 



10 



LIST 



Operation Address 



Comments 



20 



m 



41 






LIST is used to suppress the listing of all or parts of the source program. When the 
address field specifies OFF, statements are inhibited until another LIST statement 
occurs with an address field specifying ON. Normally this switch is ON. 
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LISTCC 



Location 



Operation Address 



Comments 



10 



20 



41 



LISTCC 



m 



I 



LISTCC causes COMPASS listing control cards (SPACE, EJECT, LISTF, LIST, etc.) to 
be printed; these are normally not listed. When the address field specifies ON, control 
statements are printed until another LISTCC statement appears with OFF in the address 
field. Normally this switch is OFF. 



LISTIF 



JO 



Location 


Operation 


Address 


Comments 


1 8 


10 


20 


1 

i 41 




LISTIF 


m 


1 
i 
i 



p 



LISTIF allows listing control over cards to be skipped within an IF range. If m is 
alphabetic OFF, listing of skipped cards will be suppressed. If m is an alphabetic 
ON, skipped cards will be listed. Normally this switch is OFF. 



an 



LISTMC 



I. 



Location 


, Operation 


Address 


Comments 


1 8 


10 


20 


41 




LISTMC 


m 





LISTMC allows listing control over the listing of macro calls. If m is an alphabetic 
OFF, listing of macro call lines is suppressed. If m is an alphabetic ON, macro call 
lines are listedo Normally this switch is ON. 
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BOX 



O 



Location 



Operation Address 



Comments 



10 



20 



l 41 



BOX 



I 






BOX provides a convenient way to offset a collection of comments from machine 
instructions. When the BOX pseudo is encountered, its position on the assembly listing 
is replaced by a string of alternate column asterisks in the card image portion of the 
COMPASS output. This results in the BOX pseudo being treated as a comment card. 
COMPASS then inserts asterisks in columns 1 and 80 of all source statements following 
the BOX pseudo until and EBOX pseudo instruction is encountered. This action converts 
the source statements into comments. 



EBOX 



Location 


Operation 


Address 


Comments 


1 8 


10 


J 20 


J 41 




EBOX 


1 
i 


i 
I 
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EBOX terminates a BOX pseudo instruction. The EBOX is replaced on the assembly 
listing by a string of alternate column asterisks. 



.) 



') 



CP 
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MACROS 



A macro is a sequence of instructions that may be assembled (called) whenever 
needed by a single instruction - a macro name. A macro name in the operation 
field of a statement (a macro call) results in the sequence of instructions being 
assembled at that point in the program. The use of a macro requires two steps, 
defining the sequence of instructions and calling the macro. The macro definition is 
to precede the first call to the macro in the subprogram. 



to 



All macro definitions are composed of the following: 

• Macro headings: Names the macro and declares parameters, if any, 
used in the prototype. 

• Prototype: Contains the sequence of instructions with variable elements 
expressed as parameters. 

• Macro terminator: Defines the end of the macro definition. 



MACRO HEADING 



Location 



Operation Address 



Comments 



10 



20 



I 41 



MACRO 






The MACRO pseudo instruction marks the beginning of a macro definition. It 
consists of the MACRO statement followed by a dummy parameter line. The 
dummy parameter line specifies the name of the macro and the parameters associated 
with the macro. The name of the macro is specified in the operation field of the 
dummy parameter line. The name must be at least one character in length and is 
terminated by the occurrence of a comma or blank. 



o 



The parameters may be specified in the location field, operation field, or address 
field. The parameters must begin with an alphabetic character and consist of 
alphanumeric characters. If more than one parameter is specified in one field, 
the parameters must be separated by commas. 
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Examples of macro headings: 



(3 



MACRO 
HEADING 



PROTOTYPE 



TERMINATOR 



Location 


Operation 


Address 




BETA 


MACRO 
TABLE, A 


DATA 


A macro named TABLE 
has parameters in the 
prototype called BETA, 
A, and DATA which are 
in the location, modifier, 
and address field, respec- 
tively. 


| BETA III 
lllllllll 


II equ !i! 

|| GEN, A |il 
P GEN, A |ii 


|| DATA i| 
p;| DATA i| 
•III DATA :|| 










§|endm||||| 












MACRO 
ABORT 




A macro named ABORT 
has no parameters 
within the prototype. 


■^^^•^'^■^"^'i' 


|:^j||lii||p 


§|l ABORT 1 








■:•:-:-:-:•:-:-:-:-:-:-:-:-:-:$:$:§ 


||endm|||:|| 


IllPlilililiil 










MACRO 

TIMES 


A,B 


A macro named TIMES 
has parameters in the 
prototype called A and 
B which are in the 
address field. 


|l:|:|i||lii|;i 


i^LDljis;|i|::| 

II.MP.Iijilll 


£i!p.Ai;i$ 
li?.i,.B.iii 








|||i||||:|:||:: 


:||endm'||||| 


;•:•:■:•:•:■:•;;:;;•;;;•;•:*:;;•;•;•;•:•:•; 









"•'1 



W i 



J 



a 
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PROTOTYPE 

A set of instructions called the prototype follows the macro heading. These instruc- 
tions may be machine instructions or pseudo instructions. They include use of the 
parameters specified in the macro heading. 

Reference may be made within the prototype to symbols external to the subprogram 
if they are declared by EXT pseudo instructions within either the macro or the sub- 
program. An EXT declaration within the macro remains in force for the entire 
subprogram. 

Within a macro, references can be made to symbols defined elsewhere within the 
subprogram. 

MACRO TERMINATOR 



;0 



Location 



NAME 
or blank 



Operation 



Address 



10 



ENDM 



20 



Comments 



i 41 



ENDM terminates a macro definition. The name of the macro may be specified 
in the location field but is optional except for macros within macros. 

MACRO CALLS 



Location 



Operation 



Address 



Comments 



10 



T 



| 20 



NAME 



! P 1 ,P 2 P n 



41 



The macro call names the macro to be inserted at that point in the subprogram and 
assigns a set of actual parameters to be substituted for the dummy parameters in the 
prototype. The actual parameters must appear in the same order as the parameter 
list in the macro heading. 



mur 



The operation field may contain any macro name defined for the subprogram by the 
MACRO pseudo instruction, if the macro is defined for the subprogram. COMPASS 
assembles and inserts the macro code at the point at which the macro name appears 
in the operation field. 
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The address field of the macro call contains the list of actual parameters, separated 
by commas. Single parameters may also be enclosed in parentheses within the list. 
Single parameters may not include blanks or commas unless the entire parameter is 
enclosed in parentheses. 



Example A shows how the macro call may specify symbolic name in the location field 
as well as parameters in the operation and address fields. 



Example A: 



MACRO 
DEFINITION 



MACRO 
CALL 



{ 



ASSEMBLED' 

STATEMENTS 



Location 


Operation 


Address 




MACRO 






MNAME 


P3.P4.P5 




LD,2 


P3 




AD,2 


P4 




ST, 2 


P4 




P5 






ENDM 




MROUT3 


MNAME 


BUF, WORK, (UJP A3) 


MROUT3 


• 
• 

EQU 


* 




LD,2 


BUF 




AD,2 


WORK 




ST, 2 


WORK 




UJP 


A3 




• 






• ' 


f 




• 





v.y 






o : 
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When a macro call Initiates the assembly of a macro definition, actual parameters are 
matched with dummy parameters by position. Character strings are extracted from the 
call statement and assigned to dummy parameter positions until each parameter is 
defined. The insertion of parameters within a field is terminated when a blank is 
encountered where a parameter separator should be. Dummy parameters that appear in 
the location field and are not specified in the macro call are defined with "created" 
symbols to avoid doubly defined symbols. Created symbols have the form SN, where 



© 







S = special character 

N = four-digit decimal sequence number 

Example B shows the result of created symbol insertion during assembly. When the 
operation field or operand field is terminated before all parameters in the prototype are 
defined, zeros are substituted for the undefined parameters. 

Example B; 



MACRO 
DEFINITION 



MACRO 
CALL 1 



ASSEMBLED 
INSTRUCTIONS 1 ' 



MACRO 
CALL 2 



ASSEMBLED 
INSTRUCTIONS 



Location 


Operation 


Address 


LPARM 

LP ARM 


MACRO 
MACIO 

LD,1 

AD,1 

ST, 1 

UJP 

BSS 

ENDM 


EXIT, FIRST, 

SECOND 

FIRST 

SECOND 

LPARM 

EXIT 

10 




MACIO 


ABORT, SUMl, 
SUM2 


<0001 


LD,1 

AD,1 

ST.l 

UJP 

BSS 


SUMl 

SUM2 

<0001 

ABORT 

10 




MACIO 


ABORT, SUMl 
SUM2 


<0002 


LD.l 

AD,1 

ST,1 

UJP 

BSS 


SUMl 
SUM2 
<0002 
ABORT 
10 
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NESTING OF MACROS 

The nesting of macros is a technique which allows the programmer to define a 
macro within a macro. The inside macro must have its name specified in the 
location field of its ENDM statement. The name of the outside macro is not re- 
quired with its associated ENDM statement. Any number of macros may be defined 
within an outside macro. 



Example: 



o 





Location 


Operation 


^^^ 




MACRO 










SUBR 


NAMX, PARMS 








EXT 


NAMX 








MACRO 










NAME, PARM 




OUTSIDE <^ INSIDE J 




RTJ 


NAMX 


MACRO 


MACRO N 


NAME 


RTJ 

ENDM 


PARM 




1 ' 


MACRO 






INSIDE J 


NAMP 






MACRO^ 


NAMP 


RTJ 
ENDM 


NAMX 


\J - 1 


ENDM 




ARY MACROS 






Location 


Operation 


Address 


Comments 


1 8 


10 


| 20 


41 




LIBM 


I 


m 








| 1 2 '"" 


n 



! ^y 



LEBM instructs COMPASS to obtain the named library macros from the system 
library or as specified by the M = parameter on the COMPASS control card. The 
symbols in the address field name the library macros. 



3 
) 



o ] 
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MACHINE LANGUAGE INSTRUCTIONS 






All the instructions of the MP-60 computer may be coded in the COMPASS language 
using mnemonic codes and symbolic programming techniques. This appendix describes 
how machine language instructions are expressed in COMPASS, how COMPASS 
assembles them, and how they appear in the object program. 



INSTRUCTION SUBFIELDS 

Instruction fields may be optional or mandatory. An optional field may be expressed or 
not, as the programmer requires; a mandatory field must be present and must contain 
only specific parameters. 



>o 







ADDRESS SUBFIELDS 



m, h, c, b, n and y 



r and s 



X 



A, B, and C 



The operand portion of a machine instruction may be 
represented by a symbol, literal, constant, external symbol, 
expression, or the special characters * and **. The m, h, 
c.and b nomenclature represents operand addresses of type 
word, half word, byte or character, and bit, respectively; 
n and y represent an immediate operand. 

Machine language instructions requiring byte buffer addressing 
contain r and s subfields. The fields may be represented by 
a symbol, literal, constant, external symbol, expression, or 
the special characters * and **. The r subfield represents 
the buffer first word address; the s subfield represents the 
buffer last address plus one. 

The X subfield may be represented by a constant 1 through 
31, symbols equated to the value 1 through 31, or an 
expression with nonrelocatable value 1 through 31. The X 
subfield designates an index register usage of the register 
file. The value must be consistent with the address type of 
the instruction. The specification of an index is optional 
unless specified otherwise. 

Register operation class instructions require one, two or 
three register designators. The subfields A, B, and C 
may be represented by constants, equated symbols, or non- 
relocatable expressions in the range through 31. 
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INSTRUCTION LIST FORMAT 



The machine language instruction list table format is as follows: 



^m&Jr 



BIT 



D 



The bit subfield may be represented by a constant, equated 
symbol, or a nonrelocatable expression in the range through 
31. 

The relative displacement subfield of the test instructions 
may be represented by a signed constant, symbol, 
expression, or the special character*. 



Mnemonic 
AD,F 

Instruction mnemonic 
code in COMPASS and 
required modifier 



Code 
14 

6-bit hexadecimal 
operation code or 
6-bit hexadecimal 
operation code 
and 5-bit suboper- 
ation code; express- 
ed as n. m. The 
code is not in 
packed machine 
representation 
address subfields. 



Address field 
m,x 

The address mode 
of the instruction, 
for the operand, is 
indicated by the 
symbol used. 



Operation 

F = (F) + (M) 

Representation 
of the instruct- 
ion operation. 



v„y i 



SYMBOL DEFINITIONS 



;> 



The following designators are used throughout the instruction list: 

A = file register A, specifying one of 32 source operands 

b = unmodified bit address 

B = effective bit address, after indexing; file register B, 

specifying one of 32 source operands 



J 

) 
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BIT = bit number through 31 

BR = bit register 

c = unmodified byte or character address 

C = effective byte or character address, after indexing; file 
register C, specifying one of 32 operand destinations 

D = relative displacement 

F = one of 32 file registers; specifying the operand register 

h = unmodified half-word address 

H = effective half-word address, after indexing 

IMR = interrupt mask register 

k = unmodified shift count 

K = effective shift count, after indexing 

m = unmodified word address 

M = effective word address, after indexing 

n = I/O controller number, page register number, console CRT select 
code 

p = program address register 

r = buffer first byte address 

s = buffer last byte address plus one 

S = machine state 

y = unmodified immediate operand 

Y = effective immediate operand, after indexing 

X = Index designation; specifying one of 32 file registers 
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INDEXING AND ADDRESS MODIFICATION 



M = m + (X) 
H = h + (X) 
C = c + (X) 
B = b + (X) 
K = k + (X) 
Y = y + (X) 



X - registers through 31 
X = registers through 15 
X = registers through 7 
X - registers through 31 
X - registers through 31 
X = registers through 31 



D = m - ((P) + 1); D can be plus or minus 



INSTRUCTION LIST 



16-bit result 

17-bit result 

18-bit result 

21-bit result 

6-bit result 

16-, 17-, 18-, or 21-bit result 



O 



Mnemonic 



Code Address Field 



Operation 



AABL 



37.05 A,B,C 



(C) = (A) * 32 + (B) 



AABR 



37.06 A,B,C 



(B) = (A) .AND. 1F 16 

(C) = (A) / 32 



AAL 



31 



A.B.C 



(B) = (A) * 2 

(C) = (A) * 4 



v..y 



AD,F 

ADD.F 

ADI.F 

AND 

BJPF 



14 



15 



13 



26 



2F.0B 



m,X 
m,X 

y,x 

b,X 
m,X 



F = (F) + (M) 



F, F + 1 = (F, F + 1) + (M, M + 1) 



F = (F) + Y; y sign extended 



BR = (BR) .AND. (B) 



P 
P 



M if (BR) 
(P) + 1 



= 0; else 



BJPT 



2F.0A m,X 



P 
P 



M if (BR) 
(P) + 1 



1; else 



BSK 



2E.10 A.BIT.m 



P = (P) + D if BIT of 
A - 1; else P - (P) + 1 



A-4 
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Mnemonic Code Address Field 
BSK.C 2E.12 A.BIT.m 



Operation 

P = (P) + D if BIT of 
A = 1, clear BIT; else 
P - (P) + 1, clear BIT 



BSK.S 



2E.11 A.BIT.m 



P - (P) + D if BIT of 
A « 1, set BIT; else 
P = (P) + 1, set BIT 



BSK.T 



2E.13 A.BIT.m 



P - (P) + D if BIT of 
A = 1, toggle BIT; else 
P = (P) + 1, toggle BIT 



BSK.Z 



2E.14 A,BIT,m 



P = (P) + D if BIT of 
A = 0; else P = (P) + 1 



o 



BSK,ZC 



BSK.ZS 



2E.16 A,BIT,m 



2E.15 A.BIT.m 



P = (P) + D if BIT of 
A = 0, clear BIT; else 
P = (P) + 1, clear BIT 



P = (P) + D if BIT of 
A = 0, set BIT; else 
P = (P) + 1, set BIT 



BSK.ZT 



2E.17 A,BIT,m 



P - (P) + D if BIT of 
A = 0, toggle BIT; else 
P = (P) + 1, toggle BIT 



CBIT.F 



37.02 bit.X 



bit + (X) = number of bits to 
clear in tbe F register 



CBR 



30. 0C 



BR = 



CONT.F 



3F.03 



CXPA = (NXPA) 



DINT 



3F.0F 



Disable interrupts 



o 



DLD.F 



32 



m,X 



F - (M), M - FFFFFFFF 
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Mnemonic 



Code Address Field 



Operation 



DST.F 



3F.13 



Deadstart emulator n; n indicated 
by bits 29-31 of F 



^ii^_jl^ 



DV,F 



20 



m,X 



F - (F, F + 1)/(M), F + 1 - 
remainder 



DVS,F 



DXJP 



36 m,X 
2F.1E m,X 



F = (F)/(M), no remainder 



P = P + lifXj t 0. Then 
P = M, X=X-1 
P = P + 2ifX=0 



EINT 



3F.05 



Enable interrupts; one more 
instruction executed before 
recognition 



EXM.F 



3F.03 



F,AB 


31.09 


A,C 


F,ABD 


31. 0A 


A,C 


F.ABI 


31. OB 


A,C 


F,CS 


31.01 


A,C 


F.DTS 


31.08 


A,C 



P - (F l6 _ 31 ), BR = (F U ), 

S = (F 12 -i4>. 

IMRq_7 = (Fq_7); the interrupt 
system is enabled and internal 
faults are cleared 



C = abs((A))(floating point) 



C.C+1 = abs((C,C+D) floating point 



(C) = abs((A)) 



C = cos(A) 



C = (A, A + 1); double floating 
point ► single floating point 






f,f 

F.SN 



31.03 



31.00 



A,C 
A,C 



C ■ (A); integer to floating format 



C = sin (A) 
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Mnemonic Code Address Field 



Operation 



F,SQ 
F.STD 

F.UF 

FAD.F 

FADD.F 



31.02 A,C 

31.07 A,C 

31.04 A,C 

16 m,X 

17 m,X 



C = jU5 

C, C + 1 ■ (A); single floating 
point ►double floating point 

C = (A); floating point to integer 

F = (F) + (M), floating point 

F, F + 1 - (F, F + 1) + (M, M + 1), 
floating point 



c 



FD,F 
FD.UF 

FDV.F 
FDVD,F 

FILL 



31.05 A,C 



31.06 A,C 



21 



22 



m,X 
m,X 



37.12 A,B,C 



C, C + 1 = (A, A + 1); integer to 
floating point 

C, C + 1 = (A, A + 1); floating 
point to integer 



F = (F)/(M), floating point 

F, F + 1 - (F, F + 1)/(M, M + 1), 
floating point 



C = (A), C + 1 - (A)...C + (B) -1 
= (A) character mode if bit zero of 
C not set, word mode if zero of C 
set 



FMP,F 
FMPD.F 



IE 
IF 



m,X 
m,X 



F = (F) * (M), floating point 

F, F + 1 = (F, F + 1) * (M, M + 1), 
floating point 



o 



FSB.F 
FSBD.F 



1A 



IB 



m,X 
m,X 



F = (F) - (M), floating point 

F, F + 1 - (F, F + 1) - (M, M + 1), 
floating point 



1A 06 13 05 A 
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Mnemonic Code Address Field Operation 

o 

FSK.EQ 2F.02 y,X P = (P) + 2 if (X) « y; else *~* 

P = (P) + 1 

FSK,GE 2F.00 y,X P = (P) + 2 if (X) > y; else 

P - (P) + 1 

FSK.GT 2F.04 y,X P = (P) + 2 if (X) > y; else 

P = (P) + 1 

FSK.LE 2F.01 y,X P - (P) ♦ 2 if (X) < y; else 

P - (P) + 1 

FSK.LT 2F.05 y,X P - (P) + 2 if (X) < y; else 

P = (P) + 1 

FSK,NE 2F.03 y,X P - (P) + 2 if (X) f y; else 

P - (P) + 1 

HLT 2F.0C m,X Halt Program execution; on restart ' x 

P = M V.y 

IN 3 A. 00 A,C Perform input operation from I/O TTY 

card with address register A and 
data to register C. On internal 
reject, P = (P) + 1; external 
reject, P = (P) + 2; normal return P 
- (P) + 3 

JSX 2F.09 m,X X = (P) + 1, P = m, X must be 

specified 

LCPN,F 2F.1F F - CPU number 

LD,F 09 m,X F - (M) 

LDA,F 08 m,X F - M, zero extended 



A -8 14061305 A 



o 



Mnemonic Code Address Field 



LDB 

LDBA.F 

LDC.F 

LDCA.F 

LDD,F 

LDF 



01 



07 



02 



06 



OA 



37.03 



b,X 



c,X 
c,X 
m,X 
A,B,C 



Operation 
BR - (B) 

F = b, zero extended 
F 24-31 = ( c )> zero extended 
F = C, zero extended 
F, F + 1 = (M, M + 1) 



Load Register A with the number of 
bits specified in Register C 
beginning with the bit address 
Register B 



^-j' 



LDH,F 
LDHA.F 
LDI.F 
LDM.F 

LDP.F 



03 



05 



04 



2F.11 



33 



b,X 
h,X 

y,x 

n,D 
m,X 



F 16-31 = ^ n ^» zero extended 
F = H, zero extended 
F = Y; y sign extended 

p = (P) + 1 + D, F + 1 = (P) + 2 + D, 
F+n=(P)+n+l+D 



F = (M) ; M is relocated by contents 
of relocation register 



o 



LMM 



LOPR 



LOR.F 



3F.15 A,C 
3F.12 A,C 

2A y 



Micro address C = (A) 



Operand registers, state (A20-22) 
(C, C + 1, .... C + 30) 



F = (F) .OR. y; y is 21 bits zero 
extended 



14061305 A 



A- 9 



Mnemonic 



LP.F 



Code Address Field 



29 



Operation 



F - (F) .AND. y; y is 21 bits zero 
extended 



o 



LPIR 



3F.14 A,C 



Page index register for state 

< A 20-22>. PIR " = (Co-15); 

PIR - 1 - (C 16 _ 31 ); ; PIR 

= (C + 7 16 _ 31 ) 



- 15 



LXPA.F 
LXR.F 



3F.04 



2B 



F - CXPA 



F = (F) .XOR. y; y is 21 bits zero 
extended 



MON.F 



2F.OE m 



(F) through (F + 3) to state zero 
registers 28 through 31; mi6_3i= 
(P), m 1 2-14 = (S), mn= BR, 
Mo_ 7 = (IMR0-7), P = m + 1; the 
interrupt system is disabled 



MOVA 



37.14 A,B,C 



Move and align data 

(A) = word address - from 

(B) = bit offset in first from word 
(B + 1) = number of words to transfer 
(B + 2) " number of bits in last 
transfer 

(C) = word address - to 






MOVC 



37.11 A.B.C 



C = A, C + 1 = A + 1 ... 

C + (B) - 1 = A + (B) - 1; byte 

transfer 



MOVE 



37.10 A,B,C 



C = A, C+1=A+1 ... 

C + (B) - 1 = A + (B) - 1; word 

transfer 



MOVN 



37.17 A,B,C 



Move and reformat 6-bit data bytes 
into 8-bit data bytes 

(A) = byte address - from 

(B) = number of 6-bit bytes to unpack 

(C) - byte address - to 



o 



A- 10 



14061305 A 



Mnemonic 



Code Address Field 



Operation 



MOVP 



37.16 A,B,C 



Move and reformat 8-bit data bytes 
into 6-bit data bytes 

(A) ■ byte address - from 

(B) « number of 8-bit bytes to pack 

(C) - byte address - to 



MOVT 



37.13 A,B,C 



Move and transliterate 

(A) = byte address - from 

(B) = number of 8-bit bytes to move 
(B + 1) ■ byte address - trans- 
literation table 

(C) = byte address - to 



MOVU 



37.15 A,B,C 



c 



MP.F 

MPI.F 

MPS,F 



ID 



IC 



35 



m,X 

y,x 

m,X 



Move and unalign data 

(A) = word address - from 

(B) = bit offset in first "to" word 
(B + 1) s number of words to transfer 
(B + 2) = number of bits in last 
transfer 

(C) - word address - to 



F, F + 1 = (F) * (M) 



F - (X) * y; 16-bit result 



F = (F) * (M); 32-bit result 



NBR 



N10 



30. OA 



3A.02 



A,C 



BR = (BR) 

Set/sample data channel with address/ 
control register A and data 
register C 



o 



NOP.F 



OR 



OST 



00 m,X 
27 b,X 
3F.1D A.B.C 



No operation 



BR = (BR) .OR. (B) 



(A) = new entry address 

(B) = list offset and flag 

(C) « pointer to top of list 
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Mnemonic 



OSU 



Code Address Field 



IE. A A,C 



Operation 



(A) ■ address of list entry to be 

removed 

(C) = list offset (16-bit, right 

justified) 



O 



OUT 



3A.01 A,C 



Perform output operation on I/O TTY 
card with address register A and 
data register C; P = (P) + 1 if 
internal reject/timeout; P = (P) + 2 
if external reject; P = (P) + 3 if 
normal return 



PAUS,F 



3F.19 



Pause for (F) microseconds 



PTHD 



R,AND 



37. ID A,B,C 



30.04 A,B,C 



Add new entry to threaded list 

(A) = address of new entry 

(B) = placement flag and offset 

(C) " address of list pointer 



C = (A) .AND. (B) 






R.NOT 
R,OR 
R,S* 
R,S/ 



30.08 



30.05 



30. 0D 



30. 0E 



A,B,C 
A,B,C 
A,B,C 
A,B,C 



C - (B) ; B = (A), one's complement 



C - (A) .OR. (B) 



C = (A) * (B); 32-bit result 



C = (A) / (B); 32-bit result 



R.SCL 
R.XFR 
R.XOR 



30.07 



30.09 



30.04 



A.B.C 
A,B,C 
A,B,C 



C = (A) .AND. (B), one's complement 



C ■ - (B); B - (A) 



C = (A) .X0R. (B) 
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o 



Mnemonic 


Code 
30.00 


Aaaress nti 


R,+ 


A,B,C 


R,- 


30.01 


A.B.C 


R,* 


30.02 


A,B,C 


R,/ 


30.03 


A,B,C 



Operation 

C = (A) + (B) 

C = (A) - (B) 

C, C + 1 = (A) * (B) 

C = (A, A + 1) /(B); C + 1 
remainder 



o 



RAD, F 
RD.XFR 



25 



30. IE 



m,X 
A,B,C 



RD,+ 


30. 1C 


A.B.C 


RD,- 


30. ID 


A,B,C 


RET 


3F.12 


m,X 


RF,+ 


30.14 


A,B,C 


RF,- 


30.15 


A,B,C 


RF,* 


30.16 


A.B.C 


RF,/ 


30.17 


A,B,C 


RFD.+ 


30.18 


A,B,C 



M = (F) + (M) ; C is unmodified 

C, C + 1 = (B, B + 1); B, B + 1 = 
(A, A = 1) 

C, C + 1 - (A, A + 1) + (B, B + 1) 



C, C + 



1 - (A, A + 1) - (B, B + 1) 



Restore data stored by SAV 



C = (A) + (B), floating point 



C = (A) - (B), floating point 



C - (A) * (B), floating point 



C = (A) / (B), floating point 



C, C + 1 = (A, A + 1) + (B, B + 1), 
floating point 



RFD,- 



30.19 A,B,C 



C, C + 1 = (A, A + 1) - (B, B + 1), 
floating point 
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Mnemonic 



Code Address Field 



Operation 



RFD,* 



30. 1A A,B,C 



C, C + 1 - (A, A + 1) * (B, B + 1), 
floating point 



RFD,/ 



30. IB A,B,C 



C, C + 1 = (A, A + 1) / (B, B + 1), 
floating point 



RIM.F 



3A.0D 



F - (IMR) 



RMIO 



3A.05 A,C 



C, C + 1 = (ADT register (A)) 



RMS 



30. OF 



C = time of day clock 



RPF 



3A.07 A,C 



C = (page index file address (A)) 



RPG.F 



3F.07 n 



F = (page index register n) 



RRM.F 



RSR 



RTJ 



SAV 



3A.0E 



3A.0A 



2F.08 



3F.11 



A,C 
m,X 
m,X 



F = (RTIM) 



C = read from DMA channel number A 



M = (P + 1); P = M + 1 



Store contents of file register and 
page index register for the state 
indicated by bits 20-22 of X 






SB.F 
SBD.F 



18 



19 



m,X 
m,X 



F = (F) = (M) 



F, F + 1 = (F, F + 1) - (M, M + 1) 



SBR 



30. OB 



BR « 1 



SBIT.F 



37.01 bit.X 



bit + (X) = number of bits to be set 
in the F register 
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14061305 A 



Mnemonic Code Address Field 



Operation 



SCIM.F 
SCPN,F 



3F.09 



3F.1A 



IMR = (IMR) .AND. (F) 



CPU number - (F]j_i9) 



SCRM.F 
SF,F 



3A.0C 



23 



k,X 



RTIM = (RTIM) .AND. (F) 



Shift (F) by shift count K; +K 
specifies left end around; -K 
specifies right sign extended 



SFD,F 



24 



k,X 



Shift (F, F + 1) by shift count 
K; +K specifies left end around; 
-K specifies right sign extended 



o 



SIT.F 



SMIO 



SOPR 



3F.0D 



3A.04 A,C 



3F.11 A,C 



Transfer (F) to real-time clock 
interval timeout register 



ADT regis 



ter (A) = (C, C + 1) 



C, C + 1 , C + 30 = operand 

registers, state (A 2 o-22> 



SPF 



3A.08 A,C 



Page index file address = (A) ; PIR -0 
= ((Co_i 5 )); PIR -1 = ((Ci6-31>>; 
PIR -15 = ((C + 7x6-3l)> 



SPG.F 



SPS 



3F.06 n 



3A.03 A,C 



Page index register n = (F) 



Sample position and status after ADT 
end of operation interrupt 



SRTC.F 



3F.0C 



Transfer (F) to real-time clock 
register 



\*r 



SSIM,F 



3F.08 



IMR = (IMR) .OR. (F) 
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A-15 



Mnemonic 

SSRM.F 

SST.F 

ST,F 
STB 

STBA.F 
STC.F 

STCA, FOF 

STD.F 

STF 



Code Address Field 



3A.0B 



3F.10 



11 



OB 



10 



OC 



m,X 



12 



37.04 



m,X 
b,X 
m,X 
c,X 



Operation 



RTIM = (RTIM) .OR. (F) 



Set relocation register to state 
defined by bits 20-22 of F 



M = (F) 



B = (BR) 



M ll-31 = ( F )ll-31 



C = (F) 2 4-3i 



M 14-31 = ( F >14-31 



m,X 


m, y 


i + 1 = (F, F + 1) 


A,B,C 


(A) 


■ Store field 




(B) 


= to bit address 




(C) 


= number of bits to store from 
(A), right justified 



o 



STH.F 

STHA.F 

STM,F 



0D 



0E 



2F.10 



b,X 
m,X 
n,D 



H = (F) 16 . 31 



M 15-31 = ( p H5-31 



(P) + 1 + D = (F), (P) + 2 + D 

(F + 1) (P) + n + 1 + D = 

(F + n) 



STP.F 



34 



m,X 



M = (F); M is relocated by contents 
of relocation register 



TBIT.F 



37.00 bit.X 



Bit + (X) = number of bits to toggle 
in the F register 



c 






A- 16 



14061305 A 



\ Mnemonic Code Address Field 



Operation 



TRC.F 



3F.0E 



Transfer contents of real-time clock 
register to F 



TSK,S 



3F.04 m 



P = m, state ■ S; the interrupt 
system is enabled and internal faults 
are cleared 



TST.EQ 



2C.02 A,B,m 



P = (P) + D if (A) = (B); else 
P = (P) + 1 



TST.GE 



2C.00 A,B,m 



P = (P) + D if (A) > (B); else 
P « (P) + 1 



TST,GT 



2C.04 A,B,m 



P = (P) + D if (A) > (B); else 
P = (P) + 1 



c 



TST.LE 



TST.LT 



2C.01 A,B,m 



2C.05 A,B,m 



p = (P) + D if (A) < (B); else 
P = (P) + 1 



p = (P) + D if (A) < (B); else 
P = (P) + 1 



TST.NE 



2C.03 A,B,m 



P = (P) + D if (A) i (B); else 
P = (P) + 1 



TSTD.EQ 



2D. 02 A,B,m 



P = (P) + D if (A, A + 1) = 
(B, B + 1); else P - (P) + 1 



TSTD.GE 



2D. 00 A.B.m 



P = (P) + D if (A, A + 1) > 
(B, B + 1); else P = (P) + 1 



TSTD.GT 



2D. 04 A,B,m 



P - (P) + D if (A, A + 1) > 
(B, B + 1); else P = (P) + 1 



O 



TSTD.LE 



2D. 01 A,B,m 



P ■ (P) ♦ D if (A, A + 1) < 
(B, B + 1); else P = (P) + 1 
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A-17 



Mnemonic 



TSTD.LT 



Code Address Field 



2D. 05 A,B,m 



Operation 



P = (P) + D if (A, A + 1) < 
(B, B + 1); else P - (P) + 1 



'U 



TSTD.NE 



2D. 03 A,B,m 



P - (P) + D if (A, A + 1) f 
(B, B + 1); else P - (P) + 1 



TSTF.EQ 



2C.0A A,B,m 



P = (P) + D if (A) = (B), floating 
format; else P = (P) + 1 



TSTF,GE 



2C.08 A,B,m 



P - (P) + D if (A) > (B), floating 
format; else P - (P) + 1 



TSTF.GT 



2C.0C A,B,m 



P - (P) + D if (A) > (B), floating 
format; else P ■ (P) + 1 



TSTF.LE 



2C.09 A,B,m 



P = (P) + D if (A) < (B), floating 
format; else P = (P) + 1 



TSTF.LT 



2C.0D A,B,m 



P = (P) + D if (A) < (B), floating 
format; else P = (P) + 1 



TSTF.NE 



2C.0B A,B,m 



P - (P) + D if (A) f (B), floating 
format; else P = (P) + 1 



TSTFD.EQ 



2D.0A A,B,m 



P - (P) + D if (A, A + 1) = 
(B, B + 1), floating format; 
else P - (P) + 1 



TSTFD.GE 



2D. 08 A,B,m 



P = (P) + D if (A, A + 1) > 
(B, B + 1), floating format; 
else P = (P) + 1 



TSTFD.GT 



TSTFD.LE 



2D.0C A,B,m 



2D. 09 A,B,m 



P = (P) + D if (A, A + 1) > 
(B, B + 1), floating format; 
else P = (P) + 1 



P - (P) + D if (A, A + 1) < 
(B, B + 1), floating format; 
else P = (P) + 1 



A- 18 



14061305 A 



Mnemonic Code Address Field 



Operation 



o 



TSTFD,LT 2D.0D A,B,m 



P - (P) + D if (A, A + 1) < 
(B, B + 1), floating format; 
else P » (P) + 1 



TSTFD.NE 



2D. OB A,B,m 



P - (P) + D if (A, A + 1) t 
(B, B + 1), floating format; 
else P = (P) + 1 



UJI 



UJP 



UTHD 



2F.07 m,X 
2F.06 m,X 
37. IE A,C 



P = (M) 



P = M 



Remove an entry from a threaded list 
(A) = address of entry to be removed 
(C) = offset 






WPF 



WSR 



XJP 



3A.06 



3A.09 



2F.0D 



A,C 
A,C 
m,X 



Page index file address (A) = (C) 

Write (C) to DMA state register (A) 

P = m if (X) f 0, X = (X) - 1; 
else P = (P) + 1 



XOR 



XSK 



28 



2F.0F 



b,X 



BR = (BR) .XOR. (B) 

X = (X) + 1; P = (P) + 2 if (X) + 1 
= y, zero extended; else P = (P) + 1 
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A-19 



V 



c 

f COMPASS CONTROL CARD B 





C 

c 



!' 



ft 

O 



The COMPASS control card causes the assembler to be loaded and executed under 
control of the MPX operating system. This appendix describes the parameter options 
available to the programmer. 



CARD FORMAT 

*CMP (I = u, L = u, P = u, X = u, M = u,N) 



Parameter definitions: 

%*J>> I = u: Source input is from logical unit or file u. If = u is absent, standard 

j input is assumed. Input must be specified. 

\ 

L = u: Assembly listing is on logical unit or file u. If = u is absent, standard 
output is assumed. If L is absent, no listing is generated. However, 
|' the subprogram name and error lines will be output on standard output. 

P = u: Binary output is on logical unit or file u. If = u is absent, standard 

( punch is assumed. If P is absent, no binary output is generated. 

X = u: Load and go binary output is on logical unit or file u. If = u is absent, 

( standard load and go is assumed. If X is absent, no load and go is 

generated. 

f M = u: Library input is from logical unit or file u. If M is absent, the system 

library is assumed. 

%i,;# N: Suppresses the automatic register equate assignment. 
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v^/i 



.) 



(J 



COMPASS OUTPUT 



C 



The output produced by COMPASS is an assembly listing consisting of a side-by-side list 
of assembly error codes, location, machine language, and source card image. 






ASSEMBLY ERRORS 



Error Code 

A 



Meaning 

address field error 

a) too many address subfields 

b) subfields improperly terminated 

c) subfield contains illegal elements 

d) relocation error occur 

e) constant too large for data field 



i 

v 



( 



f 



c 

D 

F 



M 



N 
O 
P 

R 
T 
U 



preset SCOM error 
doubly defined symbols 

COMPASS table full 

a) symbol table 

b) reference table 

c) macro table 

location field error 

a) location is improperly formatted 

modifier error 

a) improper or undefined modifier 

b) modifier where none allowed 

c) modifier missing 

null symbol 

op code error 

program location counter error 

a) counter different on pass 2 than on pass 1 

register usage 

address truncation error 

undefined symbol 
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o 



■'3. 

J 



::""-\ 



S \ i 



) 



o 



c 
c 



I 



o 



K.. 



€■'- 



COMPOOL/UBRARY MACROS 



A COMPASS program may include source code which is not explicitly supplied by the 
~ programmer but is extracted from a library file as a named block of COMPASS statements. 

(, Common data structures (COMPOOL) and macro prototypes (LIBM) are examples of named 

source blocks. A library file (either the standard system library or an auxiliary library) 
f containing code is generated using the PRELIB facility (Control Data publication No. 14062200). 

L Such code blocks may have any name of eight or fewer characters, except for the reserved 

name COMAC for library macros. Briefly, a library file as illustrated in Figure D-l 
f would be generated by PRELIB using the following control statements: 



*PRELIB 

* TEXT(ID=COMAC) 

Source code statements 

*ENDT 
*TEXT(ID=CBLK1) 

Source code statements 
*ENDT 
*TEXT(ID=CBLK2) 

Source code statements 
*ENDT 
*ENDPLIB 
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COMPOOL 
CBLK2 




PROGRAM NAME = COMAC 
ENTRY POINT = FFFFFFFF 



MACRO 
PROTOTYPES 



PROGRAM NAME* ■= CBLKI* 
ENTRY POINT = FFFFFFFF 



COMMON 
DECK 1 



PROGRAM NAME* = CBLK2* 
ENTRY POINT = FFFFFFFF 



COMMON 
DECK 2 



LIBRARY 
FILE 



*Address field of COMPOOL statement 



o 









Figure D-l. Library Source Code Formats 
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f\J. 



INDEX 



o 



G 


Item 


C 


ASCII 


Literal 


C. 


Constant 


Text 




Asterisk 


"v--: ■- 


Comments 


V 


Double 




ORG 




ORGR 
BOX 


| 


BSS 




BSS, B 


s 


BSS.C 




BSS.D 


I 


BSS.H 


("':■ 


Common 




DCOM 


n 


SCOM 


'%,.'- 


COMPOOL 


c 


Symbols 




COMPOOL 


c 


Constants 




Control Card 



Q 



DCOM 
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